|
|
PBHOpenDFSync |
||||
| Header: | Files.h | Carbon status: | Supported | |
Opens the data fork of a file.
OSErr PBHOpenDFSync (
HParmBlkPtr paramBlock
);
A pointer to a basic HFS parameter block.
A result code.
The relevant fields of the parameter block are:
On input, a pointer to a completion function.
On output, the result code of the function.
On input, a pointer to a pathname.
On input, a volume specification.
On output, a file reference number.
On input, the read/write permission.
On input, a parent directory ID.
The PBHOpenDFSync function creates an access path to the data fork of a file. PBHOpenDFSync is exactly like the PBHOpenSync function except that PBHOpenDFSync allows you to open a file whose name begins with a period (.).
You can open a path for writing even if it accesses a file on a locked volume, and no error is returned until a PBWriteSync, PBSetEOFSync, or PBAllocateSync call is made.
If you attempt to open a locked file for writing, PBHOpenDFSync returns the result code permErr. If you request exclusive read/write permission but another access path is already open, PBHOpenDFSync returns the reference number of the existing access path in ioRefNum and opWrErr as its function result. You should not use this reference number unless your application originally opened the file.
Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.
© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)